home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / PCBDXEXC.ZIP / UTILITY.DOC < prev   
Text File  |  1993-08-22  |  81KB  |  2,188 lines
  1. 12
  2. ==============================================================================
  3.                                                                      Utilities
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13. File Testing & Viewing Utilities
  14.  
  15. MAKEIDX
  16.  
  17. PCBEdit
  18.  
  19. PCBModem
  20.  
  21. PCBMoni
  22.  
  23. PCBNum
  24.  
  25. PCBPack
  26.  
  27. PCBSTATS
  28.  
  29. PCBText Utilities
  30.  
  31. USERNET
  32.  
  33. Miscellaneous Utilities
  34.  
  35.  
  36. File Testing & Viewing Utilities
  37.  
  38. The utilities described in this section are used primarily in your 
  39. PCBTEST.BAT and PCBVIEW.BAT files.  Each section describes the utilities in 
  40. detail.
  41.  
  42. PCBDescribe
  43.  
  44. PCBDescribe (PCBDESC.EXE) checks uploaded files for FILE_ID.DIZ files 
  45. provided by the program author.  If the uploaded file contains a description 
  46. file, it will replace the description that the user supplied with the one 
  47. provided in the file.
  48.  
  49. PCBDescribe is compatible with the following archive formats and requires the 
  50. specified program to uncompress the description files when found:
  51.  
  52. File Extension     Requires 
  53. ARC     PKXARC 
  54. ARJ     ARJ 
  55. LZH     LHA 
  56. PAK     PAK 
  57. ZIP     PKUNZIP 
  58.  
  59.  
  60. Installing PCBDescribe
  61.  
  62. PCBDescribe is used inside of the PCBTEST.BAT file, which is run to test each 
  63. upload to the system.  Place the PCBDESC.EXE file in your default \PCB 
  64. directory and insert the following line toward the top of your PCBTEST.BAT:
  65.  
  66.          IF %2==UPLOAD PCBDESC %1 %3
  67.  
  68. There is only one option; if you would like to have an additional line in the 
  69. description showing the date of the oldest and newest files in the archive, 
  70. use this command instead:
  71.  
  72.          IF %2==UPLOAD PCBDESC /D %1 %3
  73.  
  74. The word UPLOAD in the above example is case sensitive.  Make sure you type 
  75. it in uppercase letters.  Also, make sure that you have a copy each of the 
  76. required unarchive programs (PKUNZIP, ARJ, LHA, PAK, PKXARC) according to the 
  77. types of files you expect to receive.  These unarchive programs should be 
  78. placed either in your default \PCB directory, or in a subdirectory referenced 
  79. by your PATH.
  80.  
  81. PCBDescribe can be the first thing in your PCBTEST.BAT file; it will only 
  82. operate on ZIP, ARJ, LZH, PAK and ARC files (as well as self-extracting 
  83. versions of those files).
  84.  
  85. Protecting Your System From DOS Reserved Words
  86.  
  87. PCBDescribe will watch for harmful DOS reserved words such as CON, AUX, PRN, 
  88. CLOCK$, COMx, LPTx, and, if found in the archive, will rename the file by 
  89. incrementing the last letter of the filename by one.  The following 
  90. illustrates what the filenames will be renamed to:
  91.  
  92. *.ARC  ≡  *.ARD
  93. *.ARJ  ≡  *.ARK
  94. *.EXE  ≡  *.EXF
  95. *.LHA  ≡  *.LHB
  96. *.PAK  ≡  *.PAL
  97. *.ZIP  ≡  *.ZIQ
  98.  
  99. Once the filename has been renamed, a line will be added to the description 
  100. of the file indicating the reason for the rejecting. Finally, PCBDescribe 
  101. will exit to DOS with an errorlevel of 5 to indicate a problem with the file 
  102. so further testing of the file can be avoided saving the system from a lockup 
  103. that could occur if you have a testing program which does not watch for DOS 
  104. reserved words.
  105.  
  106. It is recommended that immediately after the execution of PCBDescribe, you 
  107. insert a line in the PCBTEST.BAT file which reads:
  108.  
  109.          IF ERRORLEVEL == 5 GOTO END
  110.  
  111. At the bottom of your PCBTEST.BAT file have a line which has nothing but :END 
  112. on it.  This will allow PCBDescribe's errorlevel 5 to signal that the rest of 
  113. the testing process should be skipped.  For more information on testing 
  114. errorlevels in batch files, refer to your DOS manual.
  115.  
  116. Errorlevels Returned
  117.  
  118. PCBDescribe will return errorlevels to your batch file to indicate what it 
  119. has done.  These errorlevels can be tested and used for your own purposes.  
  120. The following values are returned:
  121.  
  122.     0    No processing performed
  123.         
  124.         1       File was not a supported archive or contents were damaged
  125.  
  126.     2    Description was updated (found a FILE_ID.DIZ or DESC.SDI)
  127.  
  128.         3       Description was updated (no description file found but the 
  129.                 line showing the newest and oldest dates was added to the 
  130.                 description).
  131.  
  132.         4       Found description file but unable to process.  This could 
  133.                 occur if the program to uncompress the archive is not found.
  134.  
  135.         5       Found a DOS reserved word, renamed the file, modified the 
  136.                 description.  No further actions have been taken nor should 
  137.                 be taken by other programs.
  138.  
  139. The Description File
  140.  
  141. PCBDescribe will accept descriptions contained in FILE_ID.DIZ files found in 
  142. the archive being tested.  The FILE_ID.DIZ file is an ASCII text file, and 
  143. can contain up to 10 lines of 45 characters each.  The first line of this 
  144. file is the program name and version, and the following lines describe the 
  145. function of the program.  It is recommended that formatting codes (such as 
  146. ASCII line drawing characters) NOT be used.
  147.  
  148. PCBDescribe will also detect and use descriptions contained in DESC.SDI files 
  149. if they are present.  No other description file formats are supported.
  150.  
  151. ATTENTION!  The FILE_ID.DIZ file format is intended for the program author's 
  152. use in providing a coherent description of the program.  In this way, the 
  153. author and the SysOp can be assured that the program will be properly 
  154. described when uploaded to a BBS.  DO NOT use this file for BBS advertising!
  155.  
  156. TESTFILE
  157.  
  158. Used to determine the extension of a filename and exit with an errorlevel.
  159.  
  160. Syntax
  161.  
  162. TESTFILE [filename] [ext] [ext] ... [ext]
  163.  
  164. Command Line Parameters
  165.  
  166. [filename]      The filename you want to check to determine the extension. If 
  167.                 you are using TESTFILE in your PCBVIEW or PCBTEST batch 
  168.                 files, specify %1 for the filename.
  169.  
  170. [ext]           These parameters reference the filename extensions you want 
  171.                 to check for.  If the filename you specify matches one of the 
  172.                 extensions you enter as a parameter, PCBoard will exit with a 
  173.                 unique errorlevel.  By testing the errorlevel returned, you 
  174.                 can determine the extension of the filename.
  175.  
  176. Description
  177.  
  178. When you are passing a filename as a parameter to a batch file, quite often 
  179. it is useful to know the extension of the file. Once you know the extension 
  180. of the file, you can perform special processing.  For example you may want to 
  181. treat files that end in .TXT different from those that end with .ZIP or .ARJ.
  182.  
  183. To determine the extension of the file, you must specify the filename to test 
  184. and the extension that you want to test on the command line when you execute 
  185. TESTFILE.  The errorlevel that is returned will determine the extension of 
  186. the file.
  187.  
  188. Errorlevels Returned
  189.  
  190. The errorlevel returned by TESTFILE is based on the placement of the 
  191. extension on the command line.  The following example illustrates:
  192.  
  193. TESTFILE FILENAME.TXT ZIP ARJ LHA TXT
  194.  
  195. If you type this line at a DOS command prompt, TESTFILE will return an 
  196. errorlevel of 4.  Why 4?  The reason that errorlevel 4 is returned is that it 
  197. is the fourth extension specified on the command line.
  198.  
  199. What if the extension of the file is not specified on the command line as 
  200. shown in the following example?
  201.  
  202.  
  203. TESTFILE CONFIG.SYS ZIP ARJ LHA TXT
  204.  
  205.  
  206. In this situation, TESTFILE will return an errorlevel of 98. You will not 
  207. know the file extension, but you will know that it is not one you included on 
  208. the command line.
  209.  
  210. Example
  211.  
  212. Assuming you are using the following batch file named TESTIT.BAT
  213.  
  214.  
  215. @echo off
  216. testfile %1 zip arj gif
  217. if errorlevel==98 goto notknown
  218. if errorlevel==3 echo GIF file specified.
  219. if errorlevel==2 echo ARJ file specified.
  220. if errorlevel==1 echo ZIP file specified.
  221. goto end
  222.  
  223. :notknown
  224. echo Could not determine extension.
  225.  
  226. :end
  227.  
  228.  
  229. the following table will show the response for the value you pass as %1 to 
  230. the batch file:
  231.  
  232. %1 Parameter     Response From Batch File 
  233. TEXTEDIT.ZIP     ZIP file specified. 
  234. TEXTEDIT.EXE     Could not determine extension. 
  235. WOODGRAN.ARJ     ARJ file specified. 
  236. README.TXT     Could not determine extension. 
  237. SCENE.GIF     GIF file specified. 
  238.  
  239.  
  240.  
  241. VIEWZIP
  242.  
  243. This utility is designed to be used in PCBVIEW.BAT.  The ZIP filename you 
  244. specify as the first parameter will be examined. If the file is a valid ZIP, 
  245. a list of the files contained in the archive will be written to PCBVIEW.TXT.  
  246. When PCBoard returns from PCBVIEW.BAT, it checks to see if PCBVIEW.TXT 
  247. exists.  If it does, the contents of the file are displayed to the caller. 
  248. Using this method, your callers will be able to see a list of files in an 
  249. archive.
  250.  
  251. Example
  252.  
  253. In the PCBVIEW.BAT that is supplied with your copy of PCBoard, you will see 
  254. the following line:
  255.  
  256. viewzip %1
  257.  
  258. Upon returning from PCBVIEW, a report resembling the following will be 
  259. displayed:
  260.  
  261.   Filename     Length     Method    SF   Size Now    Date    Time
  262.  
  263. ------------  ---------  --------  ---- ---------- --------- -----
  264. INSTALL.EXE       40517  DeflateX    3%     39219  15 May 92 09:29
  265. PCB145.EXE       134833  DeflateX    0%    133740  09 Sep 92 11:28
  266. PCBDISK1.EXE      43774  DeflateX    0%     43633  15 May 92 10:05
  267. FILE_ID.DIZ         245  DeflateX   13%       213  08 Sep 92 12:07
  268.                                                              
  269. Total       4    219369              1%    216805
  270.  
  271.  
  272. VIEWARCH
  273.  
  274. This utility is designed to be used in PCBVIEW.BAT.  The ARC filename you 
  275. specify as the first parameter will be examined. If the file is a valid ARC 
  276. file, a list of the files contained in the archive will be written to 
  277. PCBVIEW.TXT.  When PCBoard returns from PCBVIEW.BAT, it checks to see if 
  278. PCBVIEW.TXT exists.  If it does, the contents of the file are displayed to 
  279. the caller.  Using this method, your callers will be able to see a list of 
  280. files in an archive.
  281.  
  282. Example
  283.  
  284. In the PCBVIEW.BAT that is supplied with your copy of PCBoard, you will see 
  285. the following line:
  286.  
  287. viewarch %1
  288.  
  289. Upon returning from running PCBVIEW on a file with an ARC extension, a report 
  290. resembling the following will be put in PCBVIEW.TXT and displayed by PCBoard:
  291.  
  292.   Filename       Length     Method    SF    Size Now     Date    Time
  293.  
  294. ------------   ----------  --------  ----  ----------  --------- -----
  295.  
  296. PC-PR.EXE          69,776  Squashed   28%      49,824  14 Jan 91 10:40
  297.  
  298. Total         1    69,776             28%      49,824
  299.  
  300.  
  301. MAKEIDX
  302.  
  303. If you want to speed up the time it takes PCBoard to scan the files for 
  304. download on your CD-ROM or hard drive, create one or more index files using 
  305. MAKEIDX.
  306.  
  307. Syntax
  308.  
  309. MAKEIDX [path file] [index file]
  310.  
  311. [path file]     The path file is read by MAKEIDX to determine the filenames 
  312.                 that should be stored in the index file.  This file is a 
  313.                 regular ASCII file with one path listed on each line.  If you 
  314.                 do not include an extension for this file, .PTH will be 
  315.                 assumed.
  316.  
  317. [index file]    This is the index file that will be created by MAKEIDX.  The 
  318.                 index will contain all files stored in the paths listed in 
  319.                 the path file.  There is a limit of 65,535 files per index.  
  320.                 If you have more than 65,000 files available on your system, 
  321.                 create more index files.  If you do not include an extension 
  322.                 for this file, .IDX will be assumed.
  323.  
  324. Creating the Path File
  325.  
  326. Use any ASCII text editor to create the path file.  On each line, type in a 
  327. path that you want MAKEIDX to search for files to put in the index.  If the 
  328. path you specified has child subdirectories, they will automatically be 
  329. included in the index.  For example, if you have a CD-ROM (drive J) and want 
  330. to create an index file of the entire drive, create a path file which 
  331. contains the following line:
  332.  
  333. J:\
  334.  
  335. Since MAKEIDX searches paths recursively, it will search all of the files on 
  336. drive J.  This is much faster than having to type in all of the paths on your 
  337. CD-ROM into the path file.
  338.  
  339. Another example may involve one of the hard drives on your system.  This 
  340. index may be a little more tricky because you do not want to make all of the 
  341. files on that drive available for download.  What you need to do is specify 
  342. only the paths you want MAKEIDX to search in the path file as shown in the 
  343. following example:
  344.  
  345. D:\DL1\
  346. D:\DL2\
  347. D:\DL3\
  348. D:\SPECIAL\
  349.  
  350. When you create the index, all files in the D:\DL1\, D:\DL2\, D:\DL3\, and 
  351. D:\SPECIAL\ subdirectories will be included in the index file.
  352.  
  353. NOTE:  Do not include the paths to any public or private upload file 
  354. directories in your index files.  The index files are static and do not get 
  355. updated when files are uploaded to the system.  To update the index files you 
  356. must recreate them using MAKEIDX.
  357.  
  358. Creating the Index File
  359.  
  360. Once you have created a path file you can create the index file using 
  361. MAKEIDX.  For this example, let's assume your path file is called CDROM1.PTH 
  362. and the contents of the file are as follows:
  363.  
  364. I:\
  365.  
  366. To create the index, type the following:
  367.  
  368. MAKEIDX CDROM1.PTH CDROM1.IDX
  369.  
  370. On the upper lefthand corner of your screen you will see a list of the paths 
  371. being searched.  Once the paths have been searched, PCBoard will sort the 
  372. files and write the index to disk.  You will find the index file in the 
  373. location you specified when running MAKEIDX.  Now that the index file has 
  374. been created, modify the configuration of PCBoard to use the index file you 
  375. created.
  376.  
  377. Updating PCBoard to Use Index Files
  378.  
  379. The only place PCBoard will recognize index files inside of the DLPATH.LST 
  380. file.  Each conference has a field that specifies the DLPATH.LST file that 
  381. will be used.  Once you have created an index, edit DLPATH.LST and make sure 
  382. any paths listed in your DLPATH.LST are deleted.  For example, if your 
  383. original DLPATH.LST resembled the following
  384.  
  385.  
  386. D:\DL1\
  387. D:\DL2\
  388. D:\DL3\
  389. D:\DL4\
  390. D:\DL5\
  391. D:\UPLOAD\
  392.  
  393. and you created an index which stores the filenames of the first five 
  394. directories, modify your DLPATH.LST file to read:
  395.  
  396. D:\UPLOAD\
  397.  
  398. Next, insert a line and type % followed by the location and filename of the 
  399. index you want PCBoard to use.  If you create your index in the C:\PCB\INDEX\ 
  400. subdirectory and called it CONF0.IDX, you will have the following entries in 
  401. your DLPATH.LST file:
  402.  
  403. D:\UPLOAD\
  404. %C:\PCB\INDEX\CONF0.IDX
  405.  
  406. If you do not put the % at the beginning of the line, PCBoard will not find 
  407. the index.  Instead, it will treat C:\PCB\INDEX\CONF0.IDX as a subdirectory 
  408. and attempt to search it for files.
  409.  
  410. Using Index Files With Hard Drives
  411.  
  412. Unlike a CD-ROM, the data on a hard drive can change.  Files can be deleted, 
  413. renamed, moved, or added to the drive.  To help accommodate the use of an 
  414. index file with a hard drive, PCBFiler will run REFRESH.BAT if it exists and 
  415. files have been moved, copied, or deleted on your system.
  416.  
  417. In the REFRESH.BAT file, add the necessary lines that will run MAKEIDX to 
  418. re-create all of your index files.  For example, your REFRESH.BAT may 
  419. resemble the following:
  420.  
  421. MAKEIDX C:\PCB\INDEX\CDROM1.PTH C:\PCB\INDEX\CDROM1.IDX
  422. MAKEIDX C:\PCB\INDEX\GIFS.PTH C:\PCB\INDEX\GIFS.IDX
  423.  
  424. The REFRESH.BAT file should be put in the same directory as PCBFiler or in a 
  425. subdirectory that is specified by your PATH= statement.
  426.  
  427. PCBEdit
  428.  
  429. PCBEdit is a utility which you can use to edit text files. Support for 
  430. PCBoard's @X color codes and @ macros is directly integrated into PCBEdit.
  431.  
  432. Starting PCBEdit
  433.  
  434. There are several command line parameters or options you can specify when 
  435. loading PCBEdit.  These parameters will control how PCBEdit will behave.  If 
  436. you are not yet familiar with PCBEdit, skip the sections that discuss command 
  437. line parameters.
  438.  
  439. The PCBEdit command line uses the following format:
  440.  
  441. PCBEDIT /parameter /parameter ... /parameter [filename]
  442.  
  443. The following section describes the valid command line parameters for 
  444. PCBEdit.
  445.  
  446. Command Line Parameters
  447.  
  448. /ATMAC:[@macro@]:[replacement text]
  449.  
  450. When a PCBoard @ macro is displayed in PCBEdit, default text is displayed in 
  451. their place.  To change the text that is displayed for each @ macro, use this 
  452. command line parameter.  After the colon, specify the @ macro you want to 
  453. change the default text followed by a colon and the next text to be 
  454. displayed.
  455.  
  456. Example usage:
  457.  
  458. PCBEDIT "/ATMAC:@USER@:JIM SMITH"
  459.  
  460. NOTE:  Quotes must surround any parameter which contains a space.  If no 
  461. quotes are used, the command line parameters will be mis-interpreted.
  462.  
  463. /COLOR
  464.  
  465. Forces PCBEdit to use a color display adapter card even if a monochrome card 
  466. was detected.
  467.  
  468. /LLEND:[ASCII code(s)]
  469.  
  470. Specifies a different character sequence to be appended to the last line when 
  471. a file is saved.  By default, the last line is written with a carriage return 
  472. / line feed appended to it.  With this switch, you can change it to several 
  473. carriage return/line feed pairs, an end of file character, etc.  Replace 
  474. [ASCII code(s)] with any valid ASCII codes.
  475.  
  476. Example usage:
  477.  
  478. PCBEDIT /LLEND:013,010,013,010
  479.  
  480. /MACRO:[filename]
  481.  
  482. Loads the macro filename specified by [filename].
  483.  
  484. Example usage:
  485.  
  486. PCBEDIT /MACRO:C:\PCB\PCBEDIT.MAC
  487.  
  488. /MONO
  489.  
  490. Forces PCBEdit to use a monochrome display adapter card even if a color 
  491. display is detected.
  492.  
  493. /NOAT
  494.  
  495. Forces PCBEdit to not interpret @ macros or @X codes (regardless of  whether 
  496. or not /ATX is in effect).  This setting is useful for using PCBEdit as a 
  497. text editor.
  498.  
  499. /NOATX
  500.  
  501. Forces PCBEdit to ignore @X codes and to display all text in the attribute 
  502. specified via the /STARTATTR option.
  503.  
  504. /NOBAK
  505.  
  506. Forces PCBEdit to not keep backup files.
  507.  
  508. /NOBUZZ
  509.  
  510. Disables the buzzing sound for alerting the user about error conditions.
  511.  
  512. /NODOS
  513.  
  514. Forces PCBEdit to not allow shells to DOS.
  515.  
  516. /NOIO
  517.  
  518. Disables the ALT-I, ALT-K and ALT-L functions.  Also disables the ability to 
  519. specify the filename to save in the ALT-S function.
  520.  
  521. /NOQUICK
  522.  
  523. Displays the welcome screen when PCBEdit starts.
  524.  
  525. /NOSS
  526.  
  527. Tells PCBEdit to not strip trailing spaces from lines.
  528.  
  529. /SET:[filename]
  530.  
  531. Loads the file specified by [filename] as the function key character set 
  532. (available by pressing ALT-F in PCBEdit).  
  533.  
  534. Example usage:
  535.  
  536. PCBEDIT /SET:C:\PCB\PCBEDIT,KEY
  537.  
  538. /SNOW
  539.  
  540. Tells PCBEdit to test for CGA screen snow.
  541.  
  542. /SS
  543.  
  544. Tells PCBEdit to strip trailing spaces from lines.
  545.  
  546. /STATUS:[type]
  547.  
  548. Changes the default status bar type to the type specified:
  549.  
  550.  
  551.     0 = detailed status bar with code ribbon  (Default)
  552.     1 = function key status bar with code ribbon
  553.     2 = no status bar or code ribbon
  554.  
  555. /STRIPG
  556.  
  557. Always strip the G graphics file specification (if present) prior to 
  558. attempting a file load.
  559.  
  560. /TRYNOG
  561.  
  562. Strip the G graphics file specification (if present) if a file with the G as 
  563. part of the filename doesn't exist.
  564.  
  565. REM [/option]
  566.  
  567. Removes the command line parameter from processing (works with any parameter 
  568. which begins with a forward slash [/].
  569.  
  570. Specifying Command Line Parameters
  571.  
  572. There are three ways of specifying startup options.  The first is on the 
  573. PCBEdit command line.  For example:
  574.  
  575. PCBEDIT /NOQUICK /MACRO:MAIN.MAC /SET:MAIN.SET NEWSG
  576.  
  577. The second means of specifying startup options is through the PCBEDIT 
  578. environment variable, which you can SET in your AUTOEXEC.BAT file.  An 
  579. example line would look like this:
  580.  
  581.  SET PCBEDIT=/QUICK "/ATMAC:@USER@:SCOTT ROBISON"
  582.  
  583. Finally, startup options may be specified in a configuration file.  It is 
  584. named PCBEDIT.CFG and can be located in the same directory as PCBEDIT.EXE or 
  585. in the current directory.  It can be created with any text editor, may have 
  586. as many lines as necessary, and may have several options on one line, as long 
  587. as all lines are limited to 127 characters or less.  Here's an example:
  588.  
  589.  
  590. "/ATMAC:@USER@:FIRST LAST"
  591. /NOBAK
  592. /MACRO:C:\PCB\PCBEDIT.MAC
  593. /STATUS:1
  594.  
  595.  
  596. PCBEdit searches for startup options in the following order:
  597.  
  598. PCBEDIT.CFG (first in the directory with PCBEdit, then in the current 
  599. directory)
  600.  
  601. 7PCBEDIT environment variable
  602.  
  603. PCBEDIT command line.
  604.  
  605. In this way, an option in the PCBEDIT.EXE directory configuration file can be 
  606. overridden by another option later in the same file, in the other 
  607. configuration file, environment variable or command line.
  608.  
  609. NOTE:  Parameters specified on the command line always override any prior 
  610. settings.
  611.  
  612. PCBEdit Macros
  613.  
  614. Fifteen sets of user-defined macros are supported by PCBEdit. Each set 
  615. consists of ten strings that may be accessed via the F1 - F10 function keys. 
  616. Different sets may be accessed by utilizing the SHIFT-ALT-F1 - SHIFT-ALT-F10 
  617. keys for sets 1 - 10 and the SHIFT-CTRL-1 - SHIFT-CTRL-5 keys for sets 11 - 
  618. 15.  The macros may be selected from and maintained with the ALT-G key.  Each 
  619. macro may consist of whatever text the user would like.  Additionally, the 
  620. following special sequences are recognized by PCBEdit:
  621.  
  622.         \X      Stuffs the character following backslash in the keyboard 
  623.                 buffer (\\ to stuff a literal backslash)
  624.  
  625.         \       By itself at the end of a macro with nothing following it 
  626.                 will stuff a literal backslash in the keyboard buffer
  627.  
  628.     ~X    Stuffs the lowercase letter X in the keyboard buffer
  629.  
  630.     ~#    Stuffs the code for function key F# in the keyboard buffer
  631.  
  632.         ~       By itself at the end of a macro with nothing following it 
  633.                 will stuff a literal tilde in the keyboard buffer
  634.  
  635.     #X    Stuffs the uppercase letter X in the keyboard buffer
  636.  
  637.         ##      Stuffs the code for function key Shift-F# in the keyboard 
  638.                 buffer
  639.  
  640.         #       By itself at the end of a macro with nothing following it 
  641.                 will stuff a literal pound sign in the keyboard buffer
  642.  
  643.         ^X      Stuffs a CTRL-X in the keyboard buffer
  644.         
  645.         ^#      Stuffs the code for function key control F# in the keyboard 
  646.                 buffer
  647.  
  648.         ^       By itself at the end of a macro with nothing following it 
  649.                 will stuff a literal carat in the keyboard buffer
  650.  
  651.         !X      Stuffs an ALT-X in the keyboard buffer
  652.  
  653.         !#      Stuffs the code for function key alt F# in the keyboard 
  654.                 buffer
  655.  
  656.         !       By itself at the end of a macro with nothing following it 
  657.                 will stuff a literal exclamation point in the keyboard buffer
  658.  
  659. Using PCBEdit
  660.  
  661. PCBEdit is not meant to replace screen-design programs such as TheDraw.  
  662. These programs are still incredibly useful for screen design. PCBEdit is 
  663. designed to allow you to write what we call information intensive display 
  664. files (such as NEWS and BLT files), as opposed to display intensive files 
  665. (such as WELCOME and BRDM.)
  666.  
  667. PCBEDIT.EXE will exists in the same directory where you installed PCBoard.  
  668. In fact, if you installed a brand new PCBoard, you will notice the default 
  669. editor defined in System Manager | Define Text & Graphics Editors is PCBEdit.   
  670. Because it deals with PCBoard's @X codes and @ macros, it can be used to 
  671. design all files, eliminating the need for separate graphics display files.
  672.  
  673. To load PCBEdit, type the following at the DOS prompt:
  674.  
  675.  
  676. PCBEDIT
  677.  
  678. If you already know the filename you want to edit, specify it on the command 
  679. line when you load PCBEdit.  The following illustrates how to edit 
  680. C:\PCB\GEN\NEWS:
  681.  
  682. PCBEDIT C:\PCB\GEN\NEWS
  683.  
  684. When PCBEdit is loaded, you will see the following screen:
  685.  
  686. This is the screen where you will do all of the editing.  For a brief 
  687. description and list of keyboard commands that are available in PCBEdit.  A 
  688. brief summary of the most commonly used keyboard commands follows:
  689.  
  690.         ALT-A     Change the current color attribute.  Use this to insert a 
  691.                   color at the current cursor position.
  692.         
  693.         ALT-L     Load a file into the editor.  Only one file can be loaded 
  694.                   at a time.
  695.  
  696.         ALT-S     Save the current file to disk.
  697.  
  698.         ALT-X     Exit PCBEdit.
  699.  
  700.         PgDn      View the next 23 lines in the file.
  701.  
  702.         PgUp      View the previous 23 lines in the file.
  703.  
  704.         Up        Move the cursor up one row.
  705.  
  706.         Down      Move the cursor down one row.
  707.                 
  708.         Left      Move the cursor to the left.
  709.  
  710.         Right     Move the cursor to the right.
  711.  
  712.  
  713. Answers To Common Questions
  714.  
  715.  
  716. PCBEdit saves files with a carriage return/line feed after the last line, but 
  717. I need an end of file character after the last line.   Is there a way to 
  718. accomplish this?
  719.  
  720. There are a couple of ways to do this.  One is to position yourself at the 
  721. end of the last line just before saving it and hit CTRL-Z or ALT-026 (on the 
  722. numeric keypad).  Another option, if you want it to save that way every time 
  723. you save the file, is to use the /LLEND option to change the last line ending 
  724. sequence of characters.   /LLEND:26 will save an end of file marker after the 
  725. last line instead of a CR-LF.
  726.  
  727. When I change background colors and type spaces all the way to the end of the 
  728. line it displays as expected.  But sometimes if I move the cursor off of that 
  729. line (and always after a save and reload of the same file) the background 
  730. color no longer appears across the entire line.  What happened?
  731.  
  732. The effect you desire is automatic when using screen oriented editors (such 
  733. as TheDraw and PCBDraw) because they save the entire screen (80X25), and 
  734. that's why you can only edit that size of display with those programs.  Since 
  735. PCBEdit functions more as a text editor instead of a screen editor, it 
  736. attempts to optimize the output of the file before saving by stripping 
  737. trailing spaces before writing the file to disk.  This is easily avoided by 
  738. including a color change at the end of the line back to the original 
  739. background color.  For example, to include a blue bar on a line (with nothing 
  740. else) on a line, type the following:
  741.  
  742. @X00@X1F     @XFF
  743.  
  744. Since the @XFF appears after the spaces, the spaces are treated as 
  745. significant and are saved with the file.  Since the @XFF only performs a 
  746. color change, nothing textual is displayed after the spaces, giving you the 
  747. desired effect.  Additionally, if you wish to have the color change affect 
  748. the rest of the current line you could use an @CLREOL@ macro to change the 
  749. color of the line.
  750.  
  751. I prefer the status bar format from TheDraw and PCBDraw.  Is there any way to 
  752. implement this?
  753.  
  754. You can use the ALT-T key to toggle status line types between the default 
  755. one, one that    appears more like the TheDraw/PCBDraw status line, or no 
  756. status line at all.  Or you can use the /STATUS configuration option to 
  757. select which one you want by default
  758.  
  759. If I mark a block to change the color or delete, it also removes the color 
  760. codes and non-displayable macros to the left and right of the block.  Why 
  761. does this happen and is there a way around it?
  762.  
  763. There are three block types:  block, line and character.  Line and character 
  764. are straight forward; they mark a range from the beginning to the end and 
  765. everything in-between.
  766.  
  767. A true block (any rectangular region) is different though.  In PCBoard 
  768. display files, one physical character in the document does not necessarily 
  769. equal one displayable character.  For example, @QON@ does absolutely nothing 
  770. to the display, but instructs PCBoard to do something.  Alternatively, 
  771. @BOARDNAME@ can potentially be much longer than the physical 11 characters it 
  772. occupies.  PCBEdit needs to take these cases (and others) into account in a 
  773. true rectangular block so that it can line up correctly on the left and right 
  774. sides of the block.  The only way around it is to select a line or character 
  775. block instead of a true rectangular screen block.  Just remember that L and C 
  776. blocks are handled differently than B blocks.
  777.  
  778. PCBModem
  779.  
  780. PCBModem is the utility that you should use to make sure that your modem and 
  781. copy of PCBoard are properly configured to work with one another.
  782.  
  783. Loading PCBModem
  784.  
  785. To load PCBModem, change to the drive and subdirectory where you installed 
  786. PCBoard.  At the DOS prompt, type:
  787.  
  788. PCBMODEM
  789.  
  790. Selecting A Modem
  791.  
  792. Upon loading PCBModem, you will see the following screen:
  793.  
  794. Press any key to continue selecting your modem.  The next screen you are 
  795. shown, asks you to pick the beginning letter of your modem manufacturer.  For 
  796. example, to setup a modem using generic settings, select Manufacturers D-J 
  797. from the menu on the following page.
  798.  
  799. On your screen, you will find a list of manufacturers which fit the menu 
  800. selection you entered previously.  Use the cursor keys to move the highlight 
  801. bar on your screen until your modem manufacturer is highlighted.  When it is, 
  802. press ENTER to view the modems of that manufacturer.  For example, to 
  803. configure a generic modem, select 'Generic' from the following menu:
  804.  
  805. Next, pick your modem and press enter.  For the purpose of this example, we 
  806. will select 'Generic' 9600/14400 v.42 modem.
  807.  
  808. Once your modem has been selected, you will be asked a few questions before 
  809. your modem is initialized.
  810.  
  811. Will you be operating in a multitasking environment (Y/N)?
  812.  
  813. The purpose of this question is to determine the maximum port opening speed 
  814. for initializing your modem.  Valid answers to this question are:
  815.  
  816.         N       If you enter this for your answer, you can specify the 
  817.                 maximum port opening rate that your modem supports.
  818.  
  819.         Y       This answer will restrict your port opening speed to 9600 
  820.                 bps.  The reason you are restricted is that running in a 
  821.                 multitasking environment (with multiple windows open at the 
  822.                 same time) may expose that your port rate is too high for the 
  823.                 performance of your computer and you will lose incoming 
  824.                 bytes. By gradually increasing the port rate from 9600 to 
  825.                 19200, 38400 and 57600 or 115200 (if your modem supports it), 
  826.                 you can determine the appropriate port opening speed.
  827.  
  828. Enter the port opening speed
  829.  
  830. In the field on your screen, enter a valid port opening speed which is less 
  831. than or equal to the maximum value allowed (shown on the same line as the 
  832. question).  Common port opening speeds are 2400, 9600, 19200, 38400, 57600, 
  833. and 115200.  If you enter an invalid speed or a speed that is not supported 
  834. by your modem, the default answer will be re-entered into the field.
  835.  
  836. Will you be using external COMM-DRV support (Y/N)?
  837.  
  838. Your answer to this question depends on whether or not you have the multiport 
  839. version of PCBoard and if you have installed the multiport driver.  Valid 
  840. responses to this question are:
  841.  
  842.         N       Use the standard communication routines built into PCBoard. 
  843.                 These routines can access any serial port using a standard 
  844.                 UART. If you will be use COM1, COM2, COM3, or COM4, enter 
  845.                 this response.  Next, you will be asked to enter the COM port 
  846.                 you will be using.  Enter a response between 1 and 8.  If you 
  847.                 enter a value higher than 2, you will be asked to also supply 
  848.                 the base address and IRQ of the serial port you are using.
  849.  
  850.         Y       If you have installed the multiport driver and you have the 
  851.                 multiport version of PCBoard, select this menu option.  Next, 
  852.                 you will be asked to enter the intelligent port that you will 
  853.                 be using.  Enter the port number you defined using DRVSETUP 
  854.                 (see the Multiple Nodes chapter) for the modem you are 
  855.                 attempting to initialize.
  856.  
  857. The Initialization Screen
  858.  
  859. Now that you have answered all of the questions, you will be shown 
  860. information about your modem including the modem number, description, port, 
  861. and opening speed.  Any special comments about your modem will be listed in 
  862. this section of the screen. The next section of the screen shows the modem 
  863. commands which will be used to initialize the modem.
  864.  
  865. When you agree with all of the information that is on the screen, answer Y to 
  866. the Do you want to proceed with the initialization question -- your modem 
  867. will be initialized.  If you answer N to this question, you will be returned 
  868. to the screen where you select modems from your manufacturer.
  869.  
  870. PCBModem will now attempt to initialize your modem.  It will send each 
  871. command line to your modem and wait for an OK response.  If there is no 
  872. response from your modem or the response is invalid, PCBModem will report 
  873. there is a problem with your modem .  Refer to the next section for tips on 
  874. finding the problem.  If your modem successfully initializes, you will be 
  875. asked if the new file should be created.  Answer Y to this question to update 
  876. your PCBoard configuration.
  877.  
  878. If There Is A Problem
  879.  
  880. There are numerous reasons why PCBModem may fail to initialize your modem.  
  881. The list that follows, will give you a few suggestions to help find the 
  882. solution to the problem:
  883.  
  884. Check the cabling between modem and computer.  Make sure it is plugged in 
  885. good and tight.
  886.  
  887. Insure that the RS-232 cable between your modem and your computer has all of 
  888. the  necessary wires.  A DB-25 pin straight-through cable is highly 
  889. recommended.    Some 25-9 pin cables will not be properly wired for use with 
  890. modems.
  891.  
  892. If PCBModem cannot communicate at all with your modem, check your system for 
  893. potential IRQ conflicts.  If you have two or more devices that attempt to use 
  894. the same IRQ, you will cause a conflict which may render both devices 
  895. inoperable.
  896.  
  897. If PCBModem reports that no modem is present or it found a bad UART, make 
  898. sure that you specified the proper base address when you were asked questions 
  899. about your COM port.
  900.  
  901. If you see the word ERROR printed on the screen with the initialization 
  902. string, an invalid command was sent to your modem.  Contact technical support 
  903. for additional guidance.
  904.  
  905. PCBMoni
  906.  
  907. PCBMoni enables you to view a list of who is currently online and what they 
  908. are doing on the system.  The list shown on your screen is updated every few 
  909. seconds.  In addition to viewing who is online, you can modify the 
  910. information that is shown on the screen; or if you have a network and a 
  911. spying utility, you can spy on the node number to see what is on the screen.
  912.  
  913. To load PCBMoni, change to the subdirectory where you installed PCBoard.  At 
  914. the DOS command prompt, type PCBMONI followed by the necessary command line 
  915. parameters and press ENTER.
  916.  
  917. Syntax
  918.  
  919. PCBMONI [filename] [NumNodes] [MaxOnScreen]
  920.  
  921. Command Line Parameters
  922.  
  923. [filename]
  924.  
  925. This parameter specifies the complete path and filename to your USERNET.XXX 
  926. file.  The location of this file can be found in PCBSetup | File Locations | 
  927. System Files.  If this parameter is not specified or the filename you specify 
  928. is invalid, a usage screen will be displayed showing you the correct syntax 
  929. for PCBMoni.  This parameter is required for PCBMoni to be loaded.
  930.  
  931. [NumNodes]
  932.  
  933. If you want to limit the number of nodes that will be shown on the screen, 
  934. use this parameter.  For example, you may have a 100 node license, but decide 
  935. to monitor only the first 30 nodes.  In this case, you would specify 30 for 
  936. the number of nodes to monitor.
  937.  
  938. [MaxOnScreen]
  939.  
  940. Normally the maximum number of nodes will be shown on the screen.  If you 
  941. need to limit the number of nodes that are shown on the screen at one time, 
  942. use this command line parameter. Enter the number of lines that you want to 
  943. view on the screen at any given time -- the default is 22.
  944.  
  945. Keyboard Commands
  946.  
  947.         Up      Move the highlight bar up one line.  If you are at node 1, 
  948.                 the bar will not move.
  949.  
  950.         Down    Move the highlight bar down one line.  If you are at the last
  951.                 node number that you decide to monitor, the bar will not 
  952.                 move.
  953.  
  954.         PgUp    Move the highlight bar to the next screen.
  955.  
  956.         PgDn    Move the highlihgt bar to the previous screen.
  957.  
  958.         ENTER   Execute NODE.BAT passing the node numbers as parameters.  For 
  959.                 additional information about spying on a node, see the 
  960.                 NODE.BAT section in the Batch Files chapter of this manual.
  961.  
  962.         SPACE   Edit the node record that is currently highlighted.  The Edit 
  963.                 User Net Status screen will appear on your screen.
  964.  
  965. Modifying A Node Record
  966.  
  967. To edit a node's record, move the highlight bar to the node number that you 
  968. wish to edit and press SPACE.  When you do, the following screen will be 
  969. displayed to you:
  970.  
  971.  
  972. Fields You Can Edit
  973.  
  974. Name            This field contains the name of the user that is currently 
  975.                 online.  If nobody is online on this node, the field will be 
  976.                 blank.
  977.  
  978. City            In this field, the location that the user entered when 
  979.                 creating their account will be shown.
  980.  
  981. Operation       The operation field is used by PCBoard to display information 
  982.                 about the current operation that the user is performing.  For 
  983.                 example, if the user is answering a script questionnaire, 
  984.                 this field will show the script number and the conference it 
  985.                 is being answered in.  For a list of information that is 
  986.                 displayed in this field, refer to the 11 SysOp command in the 
  987.                 PCBoard Commands chapter of this manual.
  988.  
  989. Message         Any text entered in this field will be sent to the user as a 
  990.                 broadcast message.  You can type up to a 64 character message 
  991.                 to send to the caller on the node.  When the message is 
  992.                 displayed, PCBoard will send an accompanying beep to help get 
  993.                 the attention of the caller.
  994.  
  995. Status          This field contains one character that describes what the 
  996.                 user is currently doing on the system.  A list of possible 
  997.                 status values are listed above this field.  Pick the status 
  998.                 value you want to assign to this node number.
  999.  
  1000. Saving Your Changes
  1001.  
  1002. Once you have updated the fields that you want to update, press PgDn to save 
  1003. the changes or ESC to abort the changes that you have made.
  1004.  
  1005. PCBNum
  1006.  
  1007. This utility can be used to update the number of callers to your system.  
  1008. This number is stored in the message base file for the Main Board conference.  
  1009. To load PCBNum, change to the subdirectory where you installed PCBoard and 
  1010. type PCBNUM and press ENTER.  The following question will be asked:
  1011.  
  1012. Location+Name of Main Messsage Base?
  1013.  
  1014. Enter the drive, path, and filename of your Main Board message base.  If you 
  1015. are unsure of the location of this message base, abort the program by 
  1016. pressing CTRL-C and load PCBSetup to check the location of this file.  Next, 
  1017. enter the new number of callers that have called 1your system.  Once you have 
  1018. entered this number, the message base will be updated and your system will 
  1019. use the new number that you entered.
  1020.  
  1021. PCBPack
  1022.  
  1023. This utility should be used to maintain your message bases.  You can delete 
  1024. old or received messages and even weed out duplicate messages using PCBPack.  
  1025. The interface for PCBoard is done strictly on a command parameter level.  To 
  1026. pack your message bases, use the desired command line parameter(s) which are 
  1027. described later in this section.  First, you must know the syntax to execute 
  1028. PCBPack.
  1029.  
  1030. Syntax
  1031.  
  1032. PCBPACK /parameter /parameter ... /parameter
  1033.  
  1034.  
  1035. /parameter      Refers to one or more command line parameters described later 
  1036.                 in this section.
  1037.  
  1038. Using A Configuration File
  1039.  
  1040. A configuration file enables you to specify the default command line 
  1041. parameters that will be used each time PCBPack is run.  The configuration 
  1042. file must meet the following criteria:
  1043.  
  1044. The config file must be in the current directory and named PCBPACK.CFG
  1045.  
  1046. PCBPACK.CFG must be a ASCII text file.
  1047.  
  1048. Each command line parameter must be entered on a separate line in the config 
  1049. file.
  1050.  
  1051.  
  1052. An example PCBPACK.CFG may contain the following:
  1053.  
  1054.  
  1055. /AREA:ALL
  1056. /KEEP:45
  1057. /PURGE:7
  1058. /MAXMSGS:500
  1059. /MINMSGS:200
  1060. /KILLBAK
  1061.  
  1062. Using this config file you could enter PCBPACK at the DOS
  1063. command prompt and it will be the equivalent of typing:
  1064.  
  1065.  
  1066.  
  1067. PCBPACK /AREA:ALL /KEEP:45 /PURGE:7 /MAXMSGS:500 /MINMSGS:200 /KILLBAK
  1068.  
  1069.  
  1070. NOTE:  To specify a different configuration file to use when loading PCBPack, 
  1071. use the following syntax:
  1072.  
  1073. PCBPACK @FILENAME.CFG
  1074.  
  1075. FILENAME.CFG is the filename you want to use for PCBPack's configuration.
  1076.  
  1077. PCBPACK @C:\PCB\NETMAIL.CFG
  1078.  
  1079. Miscellaneous Command Line Parameters
  1080.  
  1081. /AREA:[conferences]
  1082.  
  1083. This is the only required command line parameter.  Use this to specify the 
  1084. conference number to pack.    To specify a range of conferences to pack, 
  1085. enter the beginning conference number, followed by a dash and the ending 
  1086. conference number to pack (e.g., 3-10).  In addition, you can separate 
  1087. conferences and conference ranges with a semicolon.  If you enter ALL, each 
  1088. conference on your system will have its message base packed.
  1089.  
  1090. Example Usage:
  1091.  
  1092. PCBPACK /AREA:ALL
  1093. PCBPACK /AREA:3-15
  1094. PCBPACK /AREA:1-10;12;18-35
  1095.  
  1096.  
  1097. /CAP:[filename]
  1098.  
  1099. Specifies the filename to use for capturing the results of packing.  Most 
  1100. SysOps will pack during their event which may run at odd hours.  By referring 
  1101. to a capture file, errors and other information can be monitored.  Replace 
  1102. [filename] with the filename of the capture file to create.  If the file 
  1103. exists, the new data will be appended to the end of the file. 
  1104.  
  1105. The format of the capture file is shown in this example:
  1106.  
  1107.  
  1108. *** Packing Conference (0) -- Main Board ***
  1109.  
  1110. Memory available: 550552 bytes
  1111.  
  1112. 10149888 bytes available.
  1113.  
  1114. Number of messages kept      = 0
  1115. Number of messages removed   = 0
  1116. Number of messages processed = 0
  1117. Number of extraneous blocks  = 0
  1118.  
  1119. The following describes the lines that are recorded for each conference:
  1120.  
  1121. The conference number being packed.
  1122.  
  1123. Total amount of free space on the drive where the message base is stored.
  1124.  
  1125. The number of the messages that existed in the message base after it was 
  1126. packed.
  1127.  
  1128. Total number of messages that were removed of packed out of the message base.
  1129.  
  1130. The total number of messages before the message base was packed.
  1131.  
  1132. Total number of extraneous message blocks found in the messages being packed.
  1133.  
  1134.  
  1135. Example Usage:
  1136.  
  1137. PCBPACK /AREA:3 /CAP:PCBPACK.LOG
  1138.  
  1139.  
  1140. /CRC:[days]
  1141.  
  1142. In order to kill duplicate messages (/KILLDUP), you must maintain a CRC 
  1143. database.  Each message will generate a unique CRC value.  If two messages 
  1144. which generate the same CRC value are found in a conference, the latter 
  1145. message will be packed out.  Replace [days] with the number of days that the 
  1146. CRC database will be maintained.
  1147.  
  1148.  
  1149. Example Usage:
  1150.  
  1151. PCBPACK /AREA:33 /CRC:90 /KILLDUP
  1152.  
  1153.  
  1154. /FAST
  1155.  
  1156. Instead of displaying the normal message and packing statistics, display the 
  1157. minimum amount of information about each conference. The following shows a 
  1158. conference being packed in regular mode:
  1159.  
  1160. while this shows a conference being packed using the /FAST command line 
  1161. parameter:
  1162.  
  1163. Example Usage:
  1164.  
  1165. PCBPACK /AREA:ALL /FAST
  1166.  
  1167.  
  1168. /FILE:[filename]
  1169.  
  1170. Normally, PCBPack will look for the PCBOARD.DAT file to exist in the 
  1171. directory that you run PCBPack from.  If you want to specify where PCBPack 
  1172. can find the PCBOARD.DAT file, use this command line parameter.  In place of 
  1173. [filename], specify the path and filename where the PCBOARD.DAT you want to 
  1174. use can be found.
  1175.  
  1176.  
  1177. Example Usage:
  1178.  
  1179. PCBPACK /AREA:32 /FILE:C:\TEMP\PCBOARD.DAT
  1180.  
  1181.  
  1182. /HELP
  1183.  
  1184. This command line parameter will display brief descriptions of the command 
  1185. line parameters for PCBPack.
  1186.  
  1187. /INDEX
  1188.  
  1189. If you want to generate only an index for a message base, use this command 
  1190. line parameter.    If you suspect that an index has become corrupt, use this 
  1191. command line parameter.
  1192.  
  1193. NOTE:  When this parameter is used, PCBPack will ignore all command line 
  1194. parameters that will pack the message base.  For example, you cannot use the 
  1195. /MAXMSGS parameter with the /INDEX parameter.
  1196.  
  1197.  
  1198. Example Usage:
  1199.  
  1200. PCBPACK /AREA:9-12 /INDEX
  1201.  
  1202. /KILLBAK
  1203.  
  1204. When PCBPack processes message bases it creates backup files for each 
  1205. conference that is processed.  Should something go wrong with a message base, 
  1206. you may want to use these backup files to help rebuild the message base.  If 
  1207. you have no desire to leave these backup files on your drive, use this 
  1208. command line parameter.  When this parameter is used, the backup files will 
  1209. be deleted after each message base is processed.
  1210.  
  1211.  
  1212. Example Usage:
  1213.  
  1214.  
  1215. PCBPACK /AREA:10-35;50 /KILLBAK
  1216.  
  1217. /NOCALLER
  1218.  
  1219. When this command line parameter is used, no information about the packed 
  1220. message bases will be written to the caller logs. When pack information is 
  1221. written to the caller logs, the following format is used:
  1222.  
  1223.  
  1224. *** Packing Conference (0) -- Main Board ***
  1225. *** Packing Conference (1) -- Chatter ***
  1226.  
  1227. Each line written shows the conference number and name that was packed.  
  1228. Having this information in the caller logs is most useful when you run your 
  1229. events at hours when you are not available to watch it run. 
  1230.  
  1231. Example Usage:
  1232.  
  1233. PCBPACK /AREA:2-13 /NOCALLER
  1234.  
  1235. /OLDINDEX
  1236.  
  1237. PCBPack will check the PCB environment variable and the conference 
  1238. information to determine if it needs to create the old index files (v14.x 
  1239. compatible).  To force PCBPack to create the older index files, use this 
  1240. command line parameter:
  1241.  
  1242. Example Usage:
  1243.  
  1244.  
  1245. PCBPACK /AREA:32-60 /OLDINDEX
  1246.  
  1247.  
  1248.  
  1249. /QUIET
  1250.  
  1251. This command line switch is identical to the /FAST switch.  See the 
  1252. description of that switch for additional details.
  1253.  
  1254. /RENUMBER:[beginning number]
  1255.  
  1256. PCBoard allows you to enter in excess of 16 million messages before you will 
  1257. reach a point where you must renumber the message base(s).  If you need to 
  1258. renumber the message bases to begin with a new number, enter the new 
  1259. beginning message number in place of [beginning number].
  1260.  
  1261.  
  1262. NOTE:  When a message base is renumbered, the user records are not updated.  
  1263. If you renumber you message bases, reset the last message read pointers for 
  1264. all users affected.  If you do not, your users may miss new messages left in 
  1265. the renumbered conference.
  1266.  
  1267.  
  1268. Example Usage:
  1269.  
  1270.  
  1271. PCBPACK /AREA:99 /RENUMBER:1
  1272.  
  1273.  
  1274. /REPORT:[filename]
  1275.  
  1276. To help you keep tabs on how active the message base in each conference on 
  1277. your system is, use this command line parameter replacing [filename] with the 
  1278. filename you want to output the report to.  If the filename specified exists 
  1279. on disk, the contents of the file will be overwritten with the new report. 
  1280. The following shows the format of the report.
  1281.  
  1282.  
  1283. Conference             High      Low       Active
  1284. =====================  ========  ========  ========
  1285. (    0) Main Board          263      4264      1256
  1286. (    1) Chatter              62       264       125
  1287. (    2) Debate             3325      5634       896
  1288.                                            ========
  1289.                                                2277
  1290. Each line shows the conference number, conference name, high message number, 
  1291. low message number, and total active messages. The last line in the report 
  1292. summarizes the total number of active messages in the report.
  1293.  
  1294. If you use this command line parameter with any packing command
  1295. line parameters, the report will be generated for each
  1296. conference before the message base is packed.
  1297.  
  1298.  
  1299. Example Usage:
  1300.  
  1301. PCBPACK /AREA:ALL /REPORT:PCBPACK.RPT
  1302.  
  1303. /TIMEOUT:[seconds]
  1304.  
  1305. If PCBPack attempts to pack a message base that is currently in use, it will 
  1306. normally attempt to access it for 60 seconds before skipping the message 
  1307. base.  If you want to change the default wait time, use this command line 
  1308. parameter.  Replace [seconds] with the number of seconds you want PCBPack to 
  1309. attempt to access a message base.
  1310.  
  1311. Example Usage:
  1312.  
  1313. PCBPACK /AREA:1-10 /TIMEOUT:90
  1314.  
  1315. /UPCASE
  1316.  
  1317. This command line parameter will convert the subject of all messages to 
  1318. uppercase.  Even though PCBoard is capable of handling messages with mixed 
  1319. case subjects, it may be desirable to have all of your subjects in uppercase.
  1320.  
  1321. Example Usage:
  1322.  
  1323. PCBPACK /AREA:ALL /UPCASE
  1324.  
  1325. /UPDATE
  1326.  
  1327. PCBoard's message base format has remained the same for v14.x and v15.x.  
  1328. Both versions of PCBoard use different index files. If you are using 
  1329. third-party software which supports the v14.x index files (.NDX), use this 
  1330. parameter to update the newer index files (.IDX).  For example, if you are 
  1331. using a off-line mail door that imports mail packets but does not update the 
  1332. newer index format, use PCBPack with the /UPDATE parameter to update the new 
  1333. index files.
  1334.  
  1335. Example Usage:
  1336.  
  1337. PCBPACK /AREA:ALL /UPDATE
  1338.  
  1339. Command Line Parameters That Delete (Pack) Messages
  1340.  
  1341. One of the primary purposes of PCBPack is to delete or pack messages by 
  1342. removing older messages.  The command line parameters described in this 
  1343. section will delete messages using the criteria that is specified in the 
  1344. description of each parameter.  Regardless of the command line parameter you 
  1345. select, messages that have been killed on the BBS will be deleted.
  1346.  
  1347. /DATE:[mmddyy]
  1348.  
  1349. This command line parameter will enable you to delete any messages older than 
  1350. the date you  specify.  The date should be specified in mmddyy where mm is 
  1351. the month, dd is the day of the month, and yy is the year.  If you want to 
  1352. pack all messages that are older than 05-23-94 then you would enter the 
  1353. parameter as /DATE:052394.
  1354.  
  1355.  
  1356. Example usage:
  1357.  
  1358. PCBPACK /AREA:3-13;39 /DATE:041893
  1359.  
  1360.  
  1361. /DAYS:[number of days]
  1362.  
  1363. This command line parameter will enable you to delete any message that is 
  1364. older than the number of days that you specify. For example, if you want to 
  1365. delete any messages that are older than 90 days, you would enter the 
  1366. parameter as /DAYS:90.
  1367.  
  1368. Example usage:
  1369.  
  1370.  
  1371. PCBPACK /AREA:4 /DAYS:60
  1372.  
  1373. /KEEP:[days]
  1374.  
  1375. This command line parameter does not delete messages.  Instead, it prevents 
  1376. PCBPack from deleting any message which meet the following criteria:
  1377.  
  1378.  
  1379. The message is newer than the number of days specified.
  1380. The security on the message is RECEIVER ONLY.
  1381. The message has not been read yet.
  1382.  
  1383.  
  1384. Even if the message would normally be deleted, this parameter will take 
  1385. precedence.
  1386.  
  1387. Example Usage:
  1388.  
  1389. PCBPACK /AREA:ALL /MAXMSGS:500 /KEEP:45
  1390.  
  1391.  
  1392. /KILLALL
  1393.  
  1394. If you want to delete every message in the message bases you process, use 
  1395. this command line parameter.  You may find this parameter useful for 
  1396. restarting one or more message bases.
  1397.  
  1398.  
  1399. Example Usage:
  1400.  
  1401. PCBPACK /AREA:100-150 /KILLALL
  1402.  
  1403. /KILLDUPS
  1404.  
  1405. With netmail it is quite possible that duplicate messages may get imported 
  1406. into your system.  Rather than manually marking each duplicate message to be 
  1407. deleted, you can use this command line parameter.  If PCBPack sees two 
  1408. duplicate messages in a message base, the latter message will be deleted.  To 
  1409. properly kill duplicate messages, you must use this parameter in conjunction 
  1410. with the /CRC parameter.
  1411.  
  1412.  
  1413. Example Usage:
  1414.  
  1415.  
  1416. PCBPACK /AREA:ALL /KILLDUP /CRC:7
  1417.  
  1418. /MAXMSGS:[number]
  1419.  
  1420. To regulate the maximum number of messages in a conference, use this command 
  1421. line parameter.  This parameter is ideal for conferences which have a lot of 
  1422. messages entered each day.  By regulating the maximum number of messages, you 
  1423. will have a good estimate of the disk space required to store the messages.
  1424.  
  1425. Example Usage:
  1426.  
  1427.  
  1428. PCBPACK /AREA:ALL /MAXMSGS:500
  1429.  
  1430. /MINMSGS:[number]
  1431.  
  1432. If you want to force PCBPack to keep a minimum number of messages in a 
  1433. message base, use this command line parameter. User of this parameter is 
  1434. ideal for message bases that do not have a lot of message traffic.  If you 
  1435. were to pack using a date or number of days, there may be only a few message 
  1436. left for users to read on your system.
  1437.  
  1438. Example Usage:
  1439.  
  1440. PCBPACK /AREA:53-69;3 /MINMSGS:100
  1441.  
  1442. /PURGE:[days]
  1443.  
  1444. This command line parameter will delete any message that meet the following 
  1445. criteria:
  1446.  
  1447. The message is older than the number of days specified.  If the number of 
  1448. days is not specified, PCBPack will not do any date checking on the message.
  1449.  
  1450. The security on the message is RECEIVER ONLY.
  1451.  
  1452. The message has been read by the recipient..
  1453.  
  1454. Example Usage:
  1455.  
  1456. PCBPACK /AREA:ALL /PURGE
  1457.  
  1458. PCBPACK /AREA:ALL /PURGE:14
  1459.  
  1460. /RANGE:[low]-[high]
  1461.  
  1462. To delete messages which fall in a given range, use this command line 
  1463. parameter.  Any message number between the low and high message number 
  1464. specified will be deleted.
  1465.  
  1466. Example Usage:
  1467.  
  1468. PCBPACK /AREA:32 /RANGE:100-200
  1469.  
  1470. Diagnostic And Repair Command Line Parameters
  1471.  
  1472. The command line parameters described in this section are used for 
  1473. diagnostics and repair.  You should not use these unless instructed to do so 
  1474. by the technical support staff.
  1475.  
  1476. /DEBUG:[detail level]
  1477.  
  1478. This command line parameter will produce diagnostic information for 
  1479. diagnosing problems with PCBPack.  You should only use this parameter when 
  1480. instructed to do so by the technical support staff.  The technician you work 
  1481. with will provide the detail level number you should use.
  1482.  
  1483. Example Usage:
  1484.  
  1485. PCBPACK /AREA:ALL /DEBUG:300
  1486.  
  1487. /FIX
  1488.  
  1489. This command line parameter will insure that the message base header is 
  1490. accurate.  Use of this parameter will significantly increase the time it 
  1491. takes to pack your message base(s).
  1492.  
  1493. /REPAIR
  1494.  
  1495. This command line parameter is identical to /FIX.  Refer to the description 
  1496. of the /FIX parameter for additional details.
  1497.  
  1498. Examples
  1499.  
  1500. To delete any message that is older than 30 days but keep unread RECEIVER 
  1501. ONLY messages in conferences 1 through 10, enter the following:
  1502.  
  1503. PCBPACK /AREA:1-10 /DAYS:30 /KEEP
  1504.  
  1505. The following example demonstrates the use of several command line 
  1506. parameters.  The actions performed are described after this sample command 
  1507. line:
  1508.  
  1509. PCBPACK /AREA:1-10;20-100 /MAXMSGS:250 /KEEP /UPCASE
  1510.  
  1511. Pack the message bases of conference 1 through 10, and 20 through 100.
  1512.  
  1513. No message base will contain more than 250 messages.  Older messages will be 
  1514. deleted first.
  1515.  
  1516. Keep any message that has not been read by the recipient and is RECEIVER 
  1517. ONLY.
  1518.  
  1519. Convert all subjects to uppercase.
  1520.  
  1521. PCBSTATS
  1522.  
  1523. Syntax
  1524.  
  1525. PCBSTATS /FILE:[filename] /NODE:[number] /parameter
  1526.  
  1527. Required Command Line Parameters
  1528.  
  1529. These two command line parameters listed in this section are required for 
  1530. PCBSTATS to function properly.  If you specify an invalid filename or node 
  1531. number, the program will display an error instead of running.
  1532.  
  1533. /FILE:[filename]
  1534.  
  1535. In place of the [filename] shown with this command line
  1536. parameter, enter the location and name of your Statistics Files
  1537. (PCBSetup | File Locations | System Files).
  1538.  
  1539. /NODE:[number]
  1540.  
  1541. In place of the [number] shown with this command line parameter, enter the 
  1542. node number that you want to show statistics.  Even if you use a parameter 
  1543. that displays system statistics, you must specify this parameter for PCBStats 
  1544. to function properly.
  1545.  
  1546. Command Line Parameters to Update Statistics
  1547.  
  1548. If you want to use PCBStats to update the PCBSTATS.DAT file, pick one of the 
  1549. command line parameters listed in this section.
  1550.  
  1551. /RESETNODE
  1552.  
  1553. Resets the fields and statistics for the node number specified with the 
  1554. /NODE: parameter.
  1555.  
  1556. /RESETALL
  1557.  
  1558. Resets the fields and statistics for all nodes in your system.
  1559.  
  1560. /MAKELOCAL
  1561.  
  1562. Modify all nodes so that the local statistics are shown on all call-waiting 
  1563. screens in your system.
  1564.  
  1565. /KEEPCALLER
  1566.  
  1567. This parameter should only be used in conjunction with either the /RESETNODE 
  1568. or /RESETALL parameters.  Normally these parameter will reset not only the 
  1569. statistics, but also the last caller to each node.  If you want to keep the 
  1570. last caller information in the file while still resetting all of the 
  1571. statistics, use this parameter.
  1572.  
  1573. /MSGS:[number]
  1574.  
  1575. This parameter will add the number of new messages that you specify to the 
  1576. statistics of the node you specify.  Replace [number] with any number between 
  1577. -9,999,999 and 9,999,999.  If you specify a negative number, the number of 
  1578. messages will be subtracted rather than added.
  1579.  
  1580. /UP:[number]
  1581.  
  1582. This parameter will add the number of new uploads that you specify to the 
  1583. statistics of the node you specify.  Replace [number] with any number between 
  1584. -9,999,999 and 9,999,999.  If you specify a negative number, the number of 
  1585. uploads will be subtracted rather than added.
  1586.  
  1587. /DOWN:[number]
  1588.  
  1589. This parameter will add the number of new downloads that you specify to the 
  1590. statistics of the node you specify.  Replace [number] with any number between 
  1591. -9,999,999 and 9,999,999.  If you specify a negative number, the number of 
  1592. downloads will be subtracted rather than added.
  1593.  
  1594. /NAME:[name]
  1595.  
  1596. This parameter specifies the name of the last caller to the node that you 
  1597. specify.   Replace [name] with the user name of the caller.  This parameter 
  1598. should only be used when you are running a third-party program that does the 
  1599. logoff processing. Otherwise, PCBoard automatically updates this information.
  1600.  
  1601. /CITY:[city]
  1602.  
  1603. This parameter specifies the city of the last caller to the node that you 
  1604. specify.   Replace [city] with the city of the caller. This parameter should 
  1605. only be used when you are running a third-party program that does the logoff 
  1606. processing.  Otherwise, PCBoard automatically updates this information.
  1607.  
  1608. Command Line Parameters to View Statistics
  1609.  
  1610. These command line parameters give the ability to print statistics about a 
  1611. single node, the system or each of your nodes to the screen.  If you want to 
  1612. capture one of these reports to disk, refer to redirecting command input or 
  1613. output in your DOS manual.
  1614.  
  1615. /SHOWSYS
  1616.  
  1617. This parameter will show a single line that summarizes the statistics for all 
  1618. of the nodes in your system.  The format of the report is shown by the 
  1619. following example:
  1620.  
  1621.  
  1622.  
  1623. SYSTEM  -> Calls:    52  Messages:    30  Downloads:    82  Uploads: 3
  1624.  
  1625. /SHOWNODE
  1626.  
  1627. This parameter will display that statistics for the node number specified.  
  1628. The format of the report is as follows:
  1629.  
  1630.  
  1631.  
  1632. Node 15 -> Calls:     0  Messages:     0  Downloads:     0  Uploads:     0
  1633.  
  1634. /SHOWALL
  1635.  
  1636. This parameter will produce a report for your entire system and each of the 
  1637. nodes on your system (whether active or not).  The first 4 lines of this 
  1638. report may resemble the following:
  1639.  
  1640.  
  1641.  
  1642. SYSTEM  -> Calls:    52  Messages:    30  Downloads:    83 Uploads:     3
  1643. Node  1 -> Calls:     4  Messages:     0  Downloads:     6 Uploads:     0
  1644. Node  2 -> Calls:     8  Messages:     1  Downloads:    12 Uploads:     0
  1645. Node  3 -> Calls:     9  Messages:     3  Downloads:     7 Uploads:     0
  1646.  
  1647. Examples
  1648.  
  1649. If your PCBSTATS.DAT file is located in C:\ you would type the following to 
  1650. add one upload to node number 3:
  1651.  
  1652. PCBSTATS /FILE:C:\PCBSTATS.DAT /NODE:3 /UP:1
  1653.  
  1654. To reset the statistics for the same node (leaving the last caller to the 
  1655. node intact), enter the following:
  1656.  
  1657. PCBSTATS /FILE:C:\PCBSTATS.DAT /NODE:3 /RESETNODE /KEEPCALLER
  1658.  
  1659. To produce a report that lists the statistics for the entire system, you 
  1660. would enter the following:
  1661.  
  1662. PCBSTATS /FILE:C:\PCBSTATS.DAT /NODE:3 /SHOWSYS
  1663.  
  1664. PCBText Utilities
  1665.  
  1666. There are two utilities that are included with your PCBoard package to modify 
  1667. or report the contents of a PCBTEXT file.  If you have defined multiple 
  1668. languages on your system, you will have more than one PCBTEXT file.  The 
  1669. MKPCBTXT utility is used to edit or create a PCBTEXT file, while RDPCBTXT is 
  1670. used to output the contents of a PCBTEXT file to an ASCII file.
  1671.  
  1672. MKPCBTXT
  1673.  
  1674. PCBoard stores virtually all of the text it displays during program operation 
  1675. in a file called PCBTEXT which is normally located in the \PCB\GEN location 
  1676. on your hard disk.  The reason for placing all program text in a separate 
  1677. file is so that the SysOp can alter the default program displays, and also to 
  1678. provide support for multilingual versions of PCBoard.  The program used to 
  1679. maintain the main PCBTEXT file, as well as any additional 'language' PCBTEXT 
  1680. files, is MKPCBTXT.EXE.
  1681.  
  1682. The MKPCBTXT.EXE program will be found in the same directory that you 
  1683. installed PCBoard to.  To run the program, enter MKPCBTXT at the DOS command 
  1684. prompt.  After loading, the following screen will appear:
  1685.  
  1686. Syntax
  1687.  
  1688. MKPCBTXT [filename] /I:[recnum] "new text for the record"
  1689.  
  1690. [filename]      If you want to specify the PCBTEXT file to edit on the 
  1691.                 command line, you can do so by specifying the filename to 
  1692.                 edit, right after MKPCBTXT.
  1693.  
  1694. /I:             To automate the updating of a record in a PCBTEXT file, use 
  1695.                 this command line parameter.  After the /I:, specify the 
  1696.                 record number to replace the contents of followed by a space 
  1697.                 and the new text for the record surrounded in quotes.
  1698.  
  1699. Choosing the PCBTEXT File to Modify
  1700.  
  1701. If you do not specify the PCBTEXT file to edit on the command line, you will 
  1702. be prompted to enter the file you wish to edit. In the field at the top of 
  1703. the screen, enter the name of the PCBTEXT file that you wish to edit.  Your 
  1704. PCBTEXT files will be stored in the subdirectory specified by PCBSetup | File 
  1705. Locations | System Files.  Once a PCBTEXT file has been selected for editing, 
  1706. your screen will resemble the following:
  1707.  
  1708.  
  1709. Keyboard Commands
  1710.  
  1711.  
  1712.         ESC     Exit the current screen or action.  If you are at the first 
  1713.                 screen, pressing ESC will exit MKPCBTXT and save any changes 
  1714.                 that you have made.
  1715.  
  1716.         F2      Search for text.  This keyboard command will enable you to 
  1717.                 search all of the entries in MKPCBTXT for those entries that 
  1718.                 match the text you enter.  For each entry that matches, you 
  1719.                 will be given the option to edit it, or search for the next 
  1720.                 match.
  1721.  
  1722.         F3      Go directly to a particular record.  If you know the record 
  1723.                 number that you want to edit, use this keyboard command to 
  1724.                 jump directly to that record.  For example, if you know you 
  1725.                 want to change the Do you want graphics prompt, you can press 
  1726.                 F3 and type 149 followed by ENTER to go directly to that 
  1727.                 record.
  1728.  
  1729.         F4      If you are editing a record and decide that you would rather 
  1730.                 have it use the default text for the record (shown directly 
  1731.                 above the edit field), use this keyboard command.  Once you 
  1732.                 press F4, the text in the edit field will be changed to match 
  1733.                 the default text that is directly above it.
  1734.  
  1735.         Up      Move to the previous record number.
  1736.  
  1737.         Down    Move to the next record number.
  1738.  
  1739.         PgUp    Move back 10 records.
  1740.  
  1741.         PgDn    Move ahead 10 records
  1742.  
  1743.      CTRL-PgUp  Go to record number 1.
  1744.      
  1745.      CTRL-PgDn  Go to the last record number.
  1746.  
  1747. Editing a Record
  1748.  
  1749.  
  1750. When a record is displayed on the screen, you will see the following:
  1751.  
  1752.  
  1753.  
  1754. On this screen, you will notice a "header" at the top of the record that 
  1755. shows some useful information about the record.  You cannot edit this 
  1756. information.  The following briefly describes each piece of information:
  1757.  
  1758.  
  1759.  
  1760. Record No    Displays the number of the record you are editing.
  1761. Record Length    Displays the maximum length of the record.
  1762. Justification    Displays the type of justification that the field
  1763.                 uses:  Left, Center, or Right
  1764.  
  1765.  
  1766. To edit a record, start typing text.  The edit field is the one that is 
  1767. highlighted on your screen.   You can change the text in the field to say 
  1768. anything that you deem appropriate.  When you exit the program, your changes 
  1769. will be saved to the file automatically.
  1770.  
  1771. Special Characters In A Record
  1772.  
  1773. When editing a record, there are two special characters that you can enter in 
  1774. the highlighted field.  The following describes each character:
  1775.  
  1776.  
  1777.         ~       When MKPCBTXT saves the file, it will strip any extra spaces 
  1778.                 that are to the right of the last character.  If you need 
  1779.                 extra spaces at the end of the prompt, enter a ~ for each 
  1780.                 space that you need.
  1781.  
  1782.         _       This character only has meaning for records that prompt the 
  1783.                 caller for information.  This character signifies the end of 
  1784.                 the record and informs PCBoard not to display any question 
  1785.                 mark or guidelines for field entries.  This is particular 
  1786.                 useful when designing RIPscrip files where you want to hide 
  1787.                 the prompt.
  1788.  
  1789. Replacing a Record With a Text File
  1790.  
  1791. Sometimes you need to be able to enter more text than the edit field allows 
  1792. you to enter.  In this case, you will want to replace the record and display 
  1793. a text file instead.  In order to accomplish this, enter a % as the first 
  1794. character followed by the filename that you want to display.
  1795.  
  1796. For example, to replace record number 116 so that it gives a more thorough 
  1797. explanation of why the time has been adjusted, you would go to that record 
  1798. using F3.  Once at the record, clear the entire field by pressing CTRL-End.  
  1799. Once the field is clear, begin by typing % followed by C:\PCB\GEN\EVENT.  
  1800. Your record would now resemble the following:
  1801.  
  1802.  
  1803. Whenever the your time has been adjusted for our event message would normally 
  1804. be shown, the contents of the file C:\PCB\GEN\EVENT is displayed instead.  
  1805.  
  1806. Because PCBoard is displaying the file, you can also create security, 
  1807. graphics, and language specific versions of the file.
  1808.  
  1809. NOTE:  Not all PCBTEXT records can be replaced with files.  As a general 
  1810. rule, any record that PCBoard has to build (place text in the record as it 
  1811. displays) will not be able to support replacement.
  1812.  
  1813. Replacing a Record With a PPE File
  1814.  
  1815. Replacing a record to use a PPE is very similar to using a text file as a 
  1816. replacement.  The only difference is that instead of beginning the line with 
  1817. a %, begin the line with an ! (exclamation point).
  1818.  
  1819. For example, to replace record number 116 so that it uses a PPE, go to that 
  1820. record using F3.  Once at the record, clear the entire field by pressing 
  1821. CTRL-End.  Once the field is clear, begin by typing ! followed by 
  1822. C:\PCB\GEN\EVENT.PPE.  Your record would now resemble the following:
  1823.  
  1824. Whenever the your time has been adjusted for our event message would normally 
  1825. be shown, the C:\PCB\GEN\EVENT.PPE file will be executed instead.
  1826.  
  1827. NOTE:  Not all PCBTEXT records can be replaced with PPE files. As a general 
  1828. rule, any record that PCBoard has to build (place text in the record as it 
  1829. displays) will not be able to support replacement.
  1830.  
  1831. Replacing a Record With a Menu File
  1832.  
  1833. Replacing a record to use a MNU is very similar to using a text file or PPE 
  1834. file as a replacement.  The only difference is that instead of beginning the 
  1835. line with a % or !, begin the line with an $.
  1836.  
  1837. For example, to replace record number 1 so that it uses a MNU, go to that 
  1838. record using F3.  Once at the record, clear the entire field by pressing 
  1839. CTRL-End.  Once the field is clear, begin by typing $ followed by 
  1840. C:\PCB\GEN\COMMENT.MNU.  Your record would now resemble the example on the 
  1841. following page.
  1842.  
  1843. Whenever the leave a comment for the sysop message would normally be shown, 
  1844. the C:\PCB\GEN\COMMENT.MNU file will be used instead.
  1845.  
  1846. NOTE:  Not all PCBTEXT records can be replaced with menu files. As a general 
  1847. rule, any record that PCBoard has to build (place text in the record as it 
  1848. displays) will not be able to support replacement.
  1849.  
  1850. RDPCBTXT
  1851.  
  1852. This utility is designed to output each record in a PCBTEXT file into a 
  1853. single text file.  Using the text file you can quickly and easily find the 
  1854. record number you wish to edit.  The filename that is created will be in the 
  1855. current subdirectory and named PCBTEXT.LST.
  1856.  
  1857. Syntax
  1858.  
  1859. RDPCBTXT [filename]
  1860.  
  1861. [filename]      Specifies the PCBTEXT file that you would like to convert 
  1862.                 into ASCII text.  If the file is found, the ASCII version of 
  1863.                 the specified file will be output as PCBTEXT.LST in the 
  1864.                 current subdirectory.
  1865.  
  1866. Interpreting the Report
  1867.  
  1868. The report that is generated by RDPCBTXT is output in the following format:
  1869.  
  1870.  
  1871. 2 3 PCBoard Serial No. (if any)
  1872. 3 1 Access Denied - Upcoming Event Pending ...
  1873.  
  1874. The first column shows the record number.  The second number in this report 
  1875. shows the default color number of the prompt.  You cannot change the default 
  1876. color -- it is printed for reference purposes only.
  1877.  
  1878. USERNET
  1879.  
  1880. USERNET.EXE (USERNET) is a utility which allows you to modify the contents of 
  1881. your USERNET.DAT file.  What is your USERNET.DAT file you ask?  The 
  1882. USERNET.DAT file is where information is stored about who is online, where 
  1883. they are from, and what they are currently doing.  The USERNET.DAT file is 
  1884. also the file that is used to determine if users are available for chat and 
  1885. to display who is online via the WHO command.  An example WHO command looks 
  1886. like this:
  1887.  
  1888.  
  1889. (#)   Status                  User
  1890. ---   ---------------------   -----------------------------
  1891.   1   Available for CHAT      JIM SHELBER (PLANTATION, FLORIDA)
  1892.   2   Logging into System
  1893.   3   Available for CHAT      KIM KARBO (SALT LAKE CITY, UT)
  1894.  
  1895.  
  1896. As you can see it shows that the SysOp is on node 1 and unavailable for node 
  1897. chat.  This display also shows that the SysOp is from ANYTOWN, ANYWHERE.
  1898.  
  1899. What Can You Do With USERNET?
  1900.  
  1901. You can do all sorts of things with USERNET.  Below are some sample uses:
  1902.  
  1903.  
  1904. Change the name of someone in USERNET.DAT
  1905.  
  1906. Change the city of someone in USERNET.DAT
  1907.  
  1908. Immediately drop everyone off of the BBS if they are in PCBoard
  1909.  
  1910. Delete names out of USERNET.DAT that are "stuck"
  1911.  
  1912. Add nodes and users that do not really exist (up to your node
  1913. limit)
  1914.  
  1915. Show that a node is currently running an event
  1916.  
  1917. As you can see there are quite a few things you can do with USERNET.  If you 
  1918. use your imagination you can come up with several other uses.
  1919.  
  1920. Syntax
  1921.  
  1922. USERNET [filename] [nodenum] [status] [name] [city] [text]
  1923.  
  1924. filename
  1925.  
  1926. Specifies the full path and filename of the USERNET.XXX file to use.
  1927.  
  1928. nodenum
  1929.  
  1930. Specifies the node number you want to edit or ALL to modify all nodes.
  1931.  
  1932. status
  1933.  
  1934. Specifies the status the node(s) will be set to.  For a list of status 
  1935. values, see the Status Values heading in this section.
  1936.  
  1937. name
  1938.  
  1939. Specifies the name of the caller (up to 25 characters) or * to leave the name 
  1940. unchanged.
  1941.  
  1942. city
  1943.  
  1944. Specifies the city or location of the caller (up to 24 characters) or * for 
  1945. no change.
  1946.  
  1947. text
  1948.  
  1949. Specifies the text (up to 48 characters) to place in the operational text 
  1950. field.  This text is used to show the filename a user is transferring, the 
  1951. door that is currently opened, etc. To leave the text unchanged, enter * for 
  1952. the text.  For a list of status values that expect text in the operational 
  1953. text field, refer to the 11 SysOp command in the PCBoard Commands chapter of 
  1954. this manual.
  1955.  
  1956. NOTE: if multiple words are entered for name or city you must enclose them 
  1957. within quotation marks (e.g. "JOHN DOE" "NOWHERE, USA").
  1958.  
  1959. Status values
  1960.  
  1961.  
  1962. Letter     As shown in PCBMoni     As shown in PCBoard 
  1963. ------  ---------------------   ---------------------------
  1964. A       Available for CHAT      Available for CHAT 
  1965. B       Out to DOS              Out of Code in DOOR 
  1966. C     Chatting with Sysop     Entering a Message 
  1967. D       Inside a DOOR           Out of Code in DOOR 
  1968. E     Entering a Message     Entering a Message 
  1969. F       Viewing A File          Transferring a File 
  1970. G     CHATTING with Group     CHATTING with Group 
  1971. L     Auto Logoff Pending     Auto Logoff Pending 
  1972. M     Message      
  1973. N     Chatting w/ Node #     CHATTING with NODE # 
  1974. O     Logging Into System     Logging into System 
  1975. P     Paging the Sysop     Paging the Sysop 
  1976. R     CHAT Request Sent     CHAT Request Sent 
  1977. S     Answering Script     Entering a Message 
  1978. T     Transferring a File     Transferring a File 
  1979. U     Unavailable for CHAT     Unavailable for CHAT 
  1980. W     Waiting for Node #     Waiting for Node 
  1981. X     Drop to DOS Pending     Drop to DOS Pending 
  1982. Y     No Caller this Node     No Caller this Node 
  1983. Z     (Inactive Node)      
  1984.  
  1985.  
  1986. NOTE:  With the Y and Z status values no name or city parameters are needed.
  1987.  
  1988. Examples
  1989.  
  1990. Making It Appear A Caller Is Online
  1991.  
  1992. Sometimes as a SysOp you may want to list your name in the USERNET.DAT even 
  1993. when you are not online.  Your display might look like this:
  1994.  
  1995. (#)   Status                  User                          
  1996. ---   ---------------------   -----------------------------
  1997.   1   Unavailable for CHAT    JOE USER (ANYTOWN, ANYWHERE)
  1998.   2   Available for CHAT      JIM USER (ANYWHERE, ANYPLACE)
  1999.   3   No Caller Online        SYSOP - NOT CURRENTLY ONLINE
  2000.  
  2001. To accomplish a similar display you would do the following:
  2002.  
  2003. USERNET C:\PCB\MAIN\USERNET.XXX 3 Y N3 N3 "SYSOP - GONE FISHING"
  2004.  
  2005. The two N3s in this example are place-holders for the user name and city.  
  2006. When there is no caller online, the text field is displayed instead of the 
  2007. user name and city.  If you normally log into a node other than 3, you can 
  2008. replace the 3s in this example with the node number you log into.
  2009.  
  2010. Broadcasting All Nodes
  2011.  
  2012. If you want to broadcast all of your nodes from a DOS prompt, you can do so 
  2013. using USERNET.  For the example let's say that you need to take your system 
  2014. down.  Rather than SysOp chatting with all nodes, you can run a batch file 
  2015. which looks like the following:
  2016.  
  2017. USERNET C:\PCB\MAIN\USERNET.XXX ALL M "PLEASE LOG OFF ASAP"
  2018.  
  2019. This example uses the M status value to send the message.  This is quite 
  2020. similar to the BR SysOp command in PCBoard.  One thing that is distinctly 
  2021. different in this example is that instead of a node number, the word ALL is 
  2022. shown.  The word ALL tells USERNET to send this message to ALL nodes. 
  2023.  
  2024. NOTE:  If the user is not in PCBoard (i.e., they are in a door), the message 
  2025. will not be displayed to the user even when they come back to PCBoard.  You 
  2026. may want to pay special attention to who  is in a door when you broadcast a 
  2027. message.
  2028.  
  2029. Clearing A Name From The Node Display
  2030.  
  2031. You may run into circumstances when a user name is stuck in the node display.  
  2032. This type of scenario is most likely to happen when your bulletin board 
  2033. system involves local nodes, floating nodes, and users who reboot their 
  2034. system while online.  To clear a user's name out of node 11 on the system, 
  2035. you could issue the following command at a DOS prompt:
  2036.  
  2037. USERNET C:\PCB\MAIN\USERNET.XXX 11 Z
  2038.  
  2039. This will make it so that node 11 will not show up on the node display (using 
  2040. the WHO user command).
  2041.  
  2042. Drop All Nodes to DOS
  2043.  
  2044. In this example, we will show you how to immediately log off all nodes that 
  2045. are currently in PCBoard.  To do this, change all of the node's status to X.  
  2046. This action will drop the node to DOS as soon as possible.  If the user is 
  2047. currently in a DOOR or some other application, they will be disconnected when 
  2048. they return to PCBoard.  To mark all of your nodes to drop to DOS, use the 
  2049. following command line:
  2050.  
  2051. USERNET C:\PCB\MAIN\USERNET.XXX ALL X
  2052.  
  2053. When PCBoard reads the USERNET.DAT file, it will see the X status and  will 
  2054. disconnect the user.  Before the user is disconnected,  the Automatic Logoff 
  2055. Completed message will be displayed.
  2056.  
  2057. Miscellaneous Utilities
  2058.  
  2059. ENCRYPT
  2060.  
  2061. This utility will encrypt your user file to prevent any unauthorized persons 
  2062. who get hold of your user file from obtaining useful information from it.  
  2063. PCBoard and System Manager will automatically unencrypt the file when they 
  2064. open the file.  The following fields are encrypted:
  2065.  
  2066. password
  2067.  
  2068. city
  2069.  
  2070. data/business phone number
  2071.  
  2072. home/voice phone number
  2073.  
  2074. comment1
  2075.  
  2076. comment2
  2077.  
  2078. To encrypt the user file, you must first encrypt your user file
  2079. using the ENCRYPT program using the following syntax:
  2080.  
  2081.  
  2082. ENCRYPT [location of user file]
  2083.  
  2084. If your user file is stored in C:\PCB\MAIN\USERS, you would
  2085. enter the following:
  2086.  
  2087.  
  2088. ENCRYPT C:\PCB\MAIN\USERS
  2089.  
  2090. Once the user file has been encrypted, you must inform PCBoard that the user 
  2091. file is encrypted.  If you skip this step, these fields will appear to be 
  2092. filled with garbage and you can damage your user file.   To update PCBoard, 
  2093. answer Y to the Encrypt Users File question in PCBSetup | Configuration 
  2094. Options | System Control.
  2095.  
  2096. The USERS.SYS and DOOR.SYS files that are created by PCBoard will have 
  2097. decrypted values so that doors which read these files will continue to 
  2098. operate properly.  Any third-party programs which read the user file 
  2099. directory most likely will not work with the encrypted file and may end up 
  2100. damaging your user file.
  2101.  
  2102. WARNING:  You must enable encryption on all nodes that will be accessing an 
  2103. encrypted user file.  If you do not, you may damage your user file.
  2104.  
  2105. If you would like to decrypt the user file, use the ENCRYPT program with this 
  2106. syntax:
  2107.  
  2108. ENCRYPT /D [location of user file]
  2109.  
  2110. For example, if your user file is stored in H:\PCB\MAIN\USERS,
  2111. you would enter the following:
  2112.  
  2113. ENCRYPT /D H:\PCB\MAIN\USERS
  2114.  
  2115. Encrypting the user file is most useful when you operate in a large network 
  2116. environment where users may be able to directly access the user file.  By 
  2117. encrypting the user file, you can protect the accounts on the system because 
  2118. they cannot be viewed using a file viewing program.
  2119.  
  2120. OVLSIZE
  2121.  
  2122. The main PCBoard executable file is overlaid.  This means that only a portion 
  2123. of the executable is in memory at any given time. How much of the executable 
  2124. can be held in memory depends on two factors:  1) How much of it is resident 
  2125. (not in the overlay) and 2) How big the overlay buffer is.  You can determine 
  2126. how big of an overlay buffer you want to set for each executable using this 
  2127. utility.
  2128.  
  2129. A setting of 16 sets up a 64K overlay buffer.  This setting allows PCBoard to 
  2130. swap pieces of the executable file in and out of memory keeping up to 64K of 
  2131. it in the overlay buffer.
  2132.  
  2133. Syntax
  2134.  
  2135. OVLSIZE [filename] [buffer size]
  2136.  
  2137.  
  2138.  
  2139.         [filename]      This is the filename you want to update the overlay 
  2140.                         buffers on.  Enter the location of your PCBOARD.EXE 
  2141.                         or PCBSM.EXE.  If OVLSIZE cannot find the file you 
  2142.                         specify, it will print unable to open file specified.
  2143.  
  2144.         [buffer]        This parameter represents the new buffer size.  See 
  2145.                         Buffer Sizes for a list of valid buffer values.  If 
  2146.                         you do not specify a buffer size, the current overlay 
  2147.                         buffer size will be printed to the screen.
  2148.  
  2149. Buffer Sizes
  2150.  
  2151. The following chart in this section will show you the valid
  2152. buffer sizes that you may select:
  2153.  
  2154.  
  2155. Value     Size     Value     Size     Value     Size     Value     Size 
  2156. -----   ----    -----   ----    -----   ----    -----   ----
  2157. 1     4K     9     36K     17     68K     25     100K 
  2158. 2     8K     10     40K     18     72K     26     104K 
  2159. 3     12K     11     44K     19      76K     27     108K 
  2160. 4     16K     12     48K     20     80K     28     112K 
  2161. 5     20K     13     52K     21     84K     29     116K 
  2162. 6     24K     14     56K     22     88K     30     120K 
  2163. 7     28K     15     60K     23     92K     31     124K 
  2164. 8     32K     16     64K     24     96K     32     128K 
  2165.  
  2166.  
  2167. A higher value allows more of the executable file to be held in memory.  The 
  2168. highest possible value, of course, would simply load the entire executable 
  2169. file into memory and would never access the hard disk.  An overlay buffer of 
  2170. this size would be wasteful of memory.
  2171.  
  2172. Lower values may hurt performance by causing PCBoard to continually swap code
  2173.  
  2174. in from disk - creating more disk activity than would otherwise be necessary.
  2175.  
  2176. You may want to use a smaller value such as 16.  This lets PCBoard pull in 
  2177. the code that is running, when it is needed, and leave the rest of the code 
  2178. on disk until it is needed.
  2179.  
  2180. Allowing you to pick the buffer size allows you to tune your system to meet 
  2181. your memory and performance needs.  If you need more memory, go for a lower 
  2182. overlay buffer size.  If you need more performance, go for a higher buffer 
  2183. size.
  2184.  
  2185. NOTE:  The minimum value that you should select is 14 for PCBoard to operate 
  2186. properly.  If you plan to execute any PPE files, the minimum value you should 
  2187. select is 16.
  2188.